MediaGGetStatus(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 10 - Derived Media Handler Components / Derived Media Handler Components Reference

Functions / Managing Your Media Handler Component

MediaGGetStatus
The MediaGGetStatus function allows your derived media handler to report error conditions to the Movie Toolbox.
pascal ComponentResult MediaGGetStatus (ComponentInstance ci, 
                                    ComponentResult *statusErr);
ci
Identifies the Movie Toolbox's connection to your derived media handler.
statusErr
Contains a pointer to a component result field. If you have error information that you would like to report to the Movie Toolbox, place an appropriate result code into the field referred to by this pointer.

DESCRIPTION
The Movie Toolbox calls your MediaGGetStatus function whenever an application calls the toolbox's GetMovieStatus or GetTrackStatus function. This provides your media handler an opportunity to report any difficulties it may be having in
playing your media. You should use this mechanism to report any errors you encounter in your MediaIdle function (described in the previous section). You may use any appropriate result code.
Your derived media handler should support this function if you anticipate that you may encounter an error when playing your media. Because these errors may include such conditions as low memory or missing hardware, you should only rarely create a derived media handler that does not support this function. If your media handler does not support this function, the base media handler always sets the returned result code to noErr.

RESULT CODES
Any Component Manager result code